Draft Label/ro

Dimension

AnnotationStyleEditor

Draft

Descriere

If an object or a sub-element (face, edge or vertex) is selected when starting the command, the text can be made to display one or two attributes of the selected element, including position, length, area, volume and material. The text will then be linked to the attributes and will update if their values change.

To insert a text element without an arrow use the Draft Text command instead.

How to use

See also: Draft Tray, Draft Snap and Draft Constrain.

Opţiuni

The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts.

The following label types are available:

Notes

• The direction of the second segment of the leader determines the alignment of the text. If the segment is horizontal and pointing to the right the text is aligned to the left and vice versa. If the second segment goes vertically up, the text is aligned to the left. If it goes vertically down, the text is aligned to the right.
• Draft Labels created or saved with FreeCAD version 0.21 are not backward compatible.

Proprietăți

See also: Property editor.

A Draft Label object is derived from an App FeaturePython object and inherits all its properties. The following properties are additional unless otherwise stated:

Data

Label

Leader

• DatePoints (VectorList): specifies the points of the leader.
• DateStraight Direction (Enumeration): specifies the direction of the first leader segment: Custom, Horizontal or Vertical.
• DateStraight Distance (Distance): specifies the length of the first leader segment. Only used if DateStraight Direction is Horizontal or Vertical. If the distance is positive, the leader starts from the right side of the text and the text aligns to the right. Otherwise the leader starts from the left side of the text and the text aligns to the left.

Target

• DateTarget (LinkSub): specifies the object and optional subelement the label is linked to.
• DateTarget Point (Vector): specifies the position of the tip of the leader, which is where the arrow is attached.

View

Annotation

• VizualizareAnnotation Style (Enumeration): specifies the annotation style applied to the label. See Draft AnnotationStyleEditor.
• VizualizareScale Multiplier (Float): specifies the general scaling factor applied to the label.

Display Options

• VizualizareDisplay Mode (Enumeration): specifies how the text is displayed. If it is World the text will be displayed on a plane defined by the DatePlacement of the label. If it is Screen the text will always face the screen. This is an inherited property. The mentioned options are the renamed options (introduced in version 0.21).

Graphics

• VizualizareArrow Size (Length): specifies the size of the symbol displayed at the tip of the leader.
• VizualizareArrow Type (Enumeration): specifies the type of symbol displayed at the tip of the leader, which can be Dot, Circle, Arrow, Tick or Tick-2.
• VizualizareFrame (Enumeration): specifies what type of frame is drawn around the text. The current options are None or Rectangle.
• VizualizareLine (Bool): specifies whether to display the leader line. If it is false only the arrow and the text are displayed.
• VizualizareLine Color (Color): specifies the color of the leader and the arrow. This is also used for the frame.
• VizualizareLine Width (Float): specifies the width of the leader. This is also used for the frame.

Text

• VizualizareFont Name (Font): specifies the font used to draw the text. It can be a font name, such as Arial, a default style such as sans, serif or mono, a family such as Arial,Helvetica,sans, or a name with a style such as Arial:Bold. If the given font is not found on the system, a default font is used instead. introduced in version 0.21
• VizualizareFont Size (Length): specifies the size of the letters. The text can be invisible in the 3D view if this value is very small. introduced in version 0.21
• VizualizareJustification (Enumeration): specifies the horizontal alignment of the text: Left, Center or Right. Only used if DateStraight Direction is Custom. Otherwise the horizontal alignment is based on the sign (positive or negative) of DateStraight Distance.
• VizualizareLine Spacing (Float): specifies the factor applied to the default line height of the text.
• VizualizareMax Chars (Integer): specifies the maximum number of characters on each line of the text.
• VizualizareText Alignment (Enumeration): specifies the vertical alignment of the text: Top, Middle or Bottom.
• VizualizareText Color (Color): specifies the color of the text.

Scripting

To create a Draft Label use the make_label method (introduced in version 0.19) of the Draft module. This method replaces the deprecated makeLabel method.

label = make_label(target_point=App.Vector(0, 0, 0),
                   placement=App.Vector(30, 30, 0),
                   target_object=None, subelements=None,
                   label_type="Custom", custom_text="Label",
                   direction="Horizontal", distance=-10,
                   points=None)

Exempluː

import FreeCAD as App
import Draft

doc = App.newDocument()

rectangle = Draft.make_rectangle(4000, 1000)
doc.recompute()

p1 = App.Vector(-200, 1000, 0)
place1 = App.Placement(App.Vector(-1000, 1300, 0), App.Rotation())

label1 = Draft.make_label(p1, place1, target_object=rectangle, distance=500, label_type="Label")
label1.ViewObject.FontSize= 200

p2 = App.Vector(-200, 0, 0)
place2 = App.Placement(App.Vector(-1000, -300, 0), App.Rotation())

label2 = Draft.make_label(p2, place2, target_object=rectangle, distance=500, label_type="Custom",
                          custom_text="Beware of the sharp edges")
label2.ViewObject.FontSize= 200

p3 = App.Vector(1000, 1200, 0)
place3 = App.Placement(App.Vector(2000, 1800, 0), App.Rotation())

label3 = Draft.make_label(p3, place3, target_object=rectangle, distance=-500, label_type="Area")
label3.ViewObject.FontSize= 200

doc.recompute()

Dimension

AnnotationStyleEditor

Draft

Draft

• Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
• Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
• Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view

---

• Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
• Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid

---

• Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
• Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
• Context menu:
  • Layer container: Merge layer duplicates, Add new layer
  • Layer: Activate this layer, Select layer contents
  • Text: Open hyperlinks
  • Wire: Flatten
  • Working plane proxy: Write camera position, Write objects state

User documentation

• Getting started
• Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
• Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

---

• Help: Tutorials, Video tutorials
• Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework

---

• Addons: Addon Manager, External workbenches, Scripting and macros

---

• Hubs: User hub, Power users hub, Developer hub